Release 10.1A: OpenEdge Development:
Messaging and ESB

moveToNext procedure

Moves the cursor to the next data item in a StreamMessage and returns its data type.

Syntax

FUNCTION moveToNext RETURNS CHARACTER.

Applies to

Message objects

Notes

Possible return values include the Unknown value (?), boolean, byte, short, char, int, long, float, double, string, or byte.
The Unknown value (?)is returned when the value of the item is NULL.
When the message is received or after the reset procedure is called, the cursor is set before the first data item.
It is an error to try to move the cursor beyond the last item.
The moveToNext procedure function cannot precisely determine certain data types. It is important to be aware of the following limitations:
String values — The moveToNext procedure returns the longchar value for a data item consisting of a string longer than 32K. If the item is a string of 32K or less, the function returns the string value for both CHARACTER and LONGCHAR data. In the latter case, it is the responsibility of the 4GL programmer to know the order of items in the StreamMessage and to call the correct function to interpret the data appropriately.
Date values — The moveToNext procedure returns the string value for all date items. The 4GL programmer must know the order of items in the StreamMessage and call the correct function to interpret the data appropriately.

See also

createStreamMessage procedure, writeBoolean procedure, writeByte procedure, writeBytesFromRaw procedure, writeChar procedure, writeDate procedure, writeDateTime procedure, writeDateTime-TZ procedure, writeDouble procedure, writeFloat procedure, writeInt procedure, writeLong procedure, writeLongString procedure, writeShort procedure, writeString procedure, endOfStream function, moveToNext procedure, readBytesToRaw procedure, readChar function, readDate function, readDateTime function, readDateTime-TZ function, readDecimal function, readInt function, readLogical function, readLongString function, readLongStringCP function

For more information, see the "StreamMessage" section.